Excel 路径生成 · Excel Path
根据文件夹路径和文件名称，自动生成带时间戳的 Excel 输出路径
📖 功能概述
一个极简但实用的工具组件：输入文件夹路径和文件名称，组件自动生成一个带时间戳的 .xlsx 文件完整路径。每次生成的文件名都唯一，避免覆盖之前导出的文件。
💡 设计初衷：在批量导出 Excel 报告时，每次生成的文件名应自动包含生成时间，方便追溯和版本管理，而不是手动重命名。
📥 输入参数
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
| 文件夹路径 (P) | Text | 必需 | Excel 文件保存的文件夹路径。支持带末尾反斜杠或不带——组件会自动处理。 |
| 文件名称 (N) | Text | 必需 | Excel 文件基础名称。可带或不带扩展名——若传入 .xlsx 后缀，组件会自动去除后重新添加。 |
📤 输出参数
| 名称 | 类型 | 说明 |
|---|---|---|
| 路径 (P) | Text | 生成的 Excel 文件完整路径。格式：{文件夹路径}\{文件名称}-{时间戳}.xlsx |
🕐 时间戳命名规则
时间戳由组件在求解时自动生成，格式为：
{yyyyMMdd}{am/pm}{HHmm}
示例：
| 输入 | 生成路径 |
|---|---|
C:\报告\ + 装配表 |
C:\报告\装配表-20260629pm1430.xlsx |
C:\报告 + 物料清单.xlsx |
C:\报告\物料清单-20260629pm1430.xlsx |
D:\导出\ + BOM |
D:\导出\BOM-20260629am0955.xlsx |
✅ 唯一性保障：时间戳精确到分钟（含上下午标记），一分钟内多次运行也不会覆盖同名文件。
🧪 典型使用场景
| 场景 | 说明 |
|---|---|
| 每日报告 | 配合 ExcelIO 的写入模式，每次运行 Grasshopper 时自动生成一份带时间戳的 Excel 报告。 |
| 批量导出 | 在循环或数据树分支中，为每个分支生成独立的输出路径，确保互不覆盖。 |
| 模板化命名 | 将工程名称、图号等作为文件名输入，自动拼装出规范化的文件路径。 |
⚠️ 注意事项
- 组件只生成路径字符串，不会创建文件夹或文件。确保文件夹路径已经存在。
- 如果输入的文件名称包含
.xlsx扩展名，组件会自动去除并重新追加，避免出现名称.xlsx.xlsx的问题。 - 文件夹路径末尾有无反斜杠均可——组件会自动规范化。
- 输出的路径可以直接接入
ExcelIO组件的「文件路径」输入。
📋 组件信息
| 名称 | Excel 路径生成 |
| 英文名 | Excel Path |
| 分类 | LK → File Management |
| 基类 | GH_Component |
| GUID | {C9731FA5-BE83-43D9-AE81-EC92E53D8A53} |